home *** CD-ROM | disk | FTP | other *** search
/ PC-SIG: World of Games / PC-SIG World of Games (CDRM1080710) (1993).iso / ENT / DISK1833.ZIP / SAPPH111.ARC / MANUAL.TXT < prev    next >
Text File  |  1989-07-31  |  82KB  |  3,170 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                 S A P P H I R E
  10.  
  11.  
  12.  
  13.                         A COMPUTER BULLETIN BOARD SYSTEM
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                  Release: 1.10
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.                                Operator's Manual
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                        P I N N A C L E   S O F T W A R E
  36.  
  37.                        P.O. Box 386, Town of Mount Royal
  38.                        Montreal, Quebec, Canada  H3P 3C6
  39.  
  40.                                  (514) 345-9578
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.                                     NOTICES
  76.  
  77. This publication could include technical  inaccuracies or typographical errors.
  78. Changes are  periodically made to the information herein; these changes will be
  79. incorporated in new editions of this publication.
  80.  
  81. Version 1.x of  Sapphire is distributed as  shareware.  Shareware terms  do not
  82. extend to the  source code of Sapphire, nor to later versions, nor accessories,
  83. unless they are declared as shareware by Pinnacle Software.
  84.  
  85. You may try  out Sapphire for 30  days.  If you  continue to use it  after that
  86. time, you must register it.  ($45)
  87.  
  88. Sapphire is Copyright (C) 1988 by Pinnacle Software.
  89. Turbo Pascal is a Trademark of Borland International.
  90. DSZ is a Trademark of Omen Technology.
  91. ARC is a Trademark of System Enhancement Associates.
  92.  
  93.  
  94.  
  95. Support for Registered Sysops
  96.  
  97.  
  98.  
  99. The Sapphire release number follows this pattern:
  100.  
  101.                     Version Number   Upgrade Level     
  102.                                  |   |                 
  103.                                  1 . 1 0 A             
  104.                                       /   \            
  105.                      Correction Level       Internal ID
  106.  
  107. A registered Sapphire owner is entitled to operate any release of Sapphire with
  108. the same  Version and Upgrade Level, and  the same or different  Internal ID or
  109. Correction  Level.   Thus,  corrections to  the  program ("bug  fixes") can  be
  110. obtained at no cost.
  111.  
  112. Additional benefits of registration are described by the REGISTER program.
  113.  
  114.  
  115.  
  116. Support for Unregistered Sysops
  117.  
  118.  
  119.  
  120. If you  are an unregistered  Sapphire operator, you may  call Pinnacle Software
  121. for assistance if  you can  not complete the  basic installation  successfully.
  122. But  you may be  able to save  yourself long-distance charges:   experience has
  123. shown us that  95% of  all installation problems  can be solved  by the  advice
  124. given in the trouble-shooting section of this manual.
  125.  
  126.  
  127.  
  128. ii
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141. Credits
  142.  
  143.  
  144.  
  145. The following people have contributed to the Sapphire project:
  146.  
  147. Programming and Design ................... Tim Campbell
  148. Marketing and Design ..................... James Ludwick
  149. Beta-testing ............................. Yves Lacombe, Steve Mitchell
  150.  
  151. Thanks also to staff members for dedication above and beyond the call of duty:
  152.  
  153. Secretarial Services ..................... Lily Wilson
  154. Mail Room ................................ T. Toc
  155. Software Librarian ....................... P. Katt
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.                                                                             iii
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207. TABLE OF CONTENTS
  208.  
  209.  
  210.  
  211. NOTICES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  ii
  212.      Support for Registered Sysops
  213.      Support for Unregistered Sysops
  214.  
  215. INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  216.      What is Sapphire?
  217.      What Isn't Sapphire?
  218.  
  219. INSTALLING SAPPHIRE . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  220.      What You Need
  221.           Hard and Floppy Disk Considerations
  222.      Basic Steps
  223.      STEP 1.  Make a Copy of the Packaged Diskettes
  224.      STEP 2.  Prepare a Place for the Files to Go
  225.      STEP 3.  Put the Files Where They Belong
  226.      STEP 4.  Updating the CONFIG.SYS File
  227.      STEP 5.  Customize Sapphire According to Your Needs
  228.           Saving Time on the Customization Step
  229.      STEP 6.  Run a Local Test
  230.           Extra Step for Floppy Diskette Users
  231.      STEP 7.  Run a Remote Test
  232.  
  233. TROUBLE-SHOOTING  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
  234.      Problem 1.  Installer Error
  235.      Problem 2.  Modem Configuration
  236.      Problem 3.  File Problem
  237.      Problem 4.  Sapphire Bug
  238.      Problem 5.  Incompatible Hardware and Software
  239.  
  240. SYSTEM OPERATION  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  241.      Duties of the System Operator
  242.      Signing On Locally
  243.      Signing on as SYSOP
  244.      Function Keys
  245.      Backups
  246.      User File Maintenance
  247.      Message File Maintenance
  248.      Library Maintenance
  249.      Files Maintenance
  250.  
  251. MISCELLANEOUS OPERATIONAL NOTES . . . . . . . . . . . . . . . . . . . . . .  18
  252.      Gear Shift
  253.      Customization
  254.           SLOGO.TXT; Other .TXT Files; Command Levels
  255.      Password Changes
  256.      The Status Line
  257.      Online Validation and Banishment
  258.      Yoo-Hoo and Rename
  259.  
  260.                                        ii
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274. MEMBER PRIVILEGES . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  22
  275.      Level 1:  Non-member
  276.      Level 2:  Basic Member
  277.      Level 3:  Special Member
  278.      Level 4:  Top Notch Member
  279.      Level 5:  Inner Circle Member
  280.      Level 6:  Aide-de-Sysop
  281.      Level 7:  Co-Sysop
  282.      Level 8:  Sysop
  283.  
  284. DOORS AND EVENTS  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  26
  285.      Definitions
  286.      Applications for Event Processing
  287.      Applications for Doors Processing
  288.      Coding Your Batch Files
  289.           How EXTERNAL.BAT Works; Batch Templates
  290.      Writing Door and Event Programs
  291.  
  292. FILE TRANSFER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  30
  293.      What is File Transfer?
  294.      Installing File Transfer
  295.      Adding Software Locally
  296.      Adding Software Remotely
  297.      How Online Documentation Works
  298.      Transfer Protocols
  299.  
  300. APPENDIX A -- ORDERING INFORMATION  . . . . . . . . . . . . . . . . . . . .  33
  301.      Additional Products from Pinnacle Software
  302.  
  303. APPENDIX B -- SAPPHIRE DESIGNER NOTES . . . . . . . . . . . . . . . . . . .  35
  304.      Some Background
  305.      Why Sapphire was Written
  306.      Notes About the Design Philosophy
  307.           Commands;  Maintenance;  40  Column  Text; The  Cool  Reception;
  308.           Conclusion
  309.  
  310. APPENDIX C -- Versions 1.1 and 2.x  . . . . . . . . . . . . . . . . . . . .  40
  311.      Thank-You
  312.  
  313. INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  41
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.                                       iii
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339. INTRODUCTION
  340.  
  341.  
  342.  
  343. What is Sapphire?
  344.  
  345.  
  346.  
  347. Sapphire is a computer bulletin-board system.  You can use it to transform your
  348. computer into  a kind  of "answering  machine", so  that  people equipped  with
  349. modems can dial up your computer,  read and send messages, browse through  text
  350. files, and exchange software.
  351.  
  352. There are countless BBS's (bulletin board systems) throughout the world.   Many
  353. are run  by businesses; most  are run by computer  hobbyists who like  to share
  354. with others the enjoyment they derive from their hobby.
  355.  
  356. All  you need to  become a "sysop"  (system operator) is an  IBM-PC computer or
  357. compatible, a modem, and a phone line dedicated to the BBS.
  358.  
  359. There are many different brands of BBS software available; Sapphire is just one
  360. example.   Each brand  of BBS suits  a different  kind of  sysop.  Sapphire  is
  361. specifically designed for:
  362.  
  363.      -- Stores
  364.      -- Computer consultants
  365.      -- Customer support lines
  366.      -- People who have never run a BBS before
  367.      -- People who have run a BBS before and found it too much work
  368.  
  369. Sapphire  is  very easy  to  set up  and  maintain.   A  moderately experienced
  370. computer user will set it up in  less than an hour and spend approximately  one
  371. hour per week performing the various duties required of a sysop.
  372.  
  373. There are many ways to design a BBS.  This system has been designed in the form
  374. of a  "conversation club".  Thus, instead of  having "users", a Sapphire system
  375. has "members".
  376.  
  377. Nevertheless, Sapphire's design is quite flexible, so you can modify it to look
  378. the way you  want.  If you  don't like the "club"  image, you can change  it to
  379. something else.
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.                                        1
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405. What Isn't Sapphire?
  406.  
  407.  
  408.  
  409. That might  sound like  a strange  question, but  we've already discussed  what
  410. Sapphire can  do, so let's take  a moment to discuss  what it won't  do.  Maybe
  411. this will save a few hours of your time!
  412.  
  413. But before we go further, let me ask you to think about this question:
  414.  
  415.                          Why do you want to run a BBS?
  416.  
  417. Sapphire  is (according to a survey  I've conducted) by far  the easiest BBS to
  418. install  and operate.   This makes  it ideal  for the people  mentioned earlier
  419. (store managers, consultants, new or over-worked sysops, etc.), but there are a
  420. few things that could make this system inappropriate to your needs.
  421.  
  422. First of all, Sapphire  is very different from other  BBS's.  If you are  a new
  423. sysop, you may  feel that you should  run a BBS that  looks like all the  other
  424. ones.  If that's the case, I ask you to try Sapphire for a month.  Find out how
  425. easy it is for both you and your users.  Then ask somebody who runs another BBS
  426. how much  time he or she spends every week  "maintaining" his or her system, or
  427. how many  users have mastered every function of the BBS.  I believe you'll find
  428. this experiment informative.
  429.  
  430. For  a  discussion of  Sapphire's  revolutionary  design, refer  to  Appendix B
  431. (Designer Notes).
  432.  
  433. There  is one kind of  sysop who will  not want to  run Sapphire.   That is the
  434. power-sysop.
  435.  
  436. The power-sysop is somebody who runs  either a multi-line system (which is  not
  437. supported by  Sapphire) or  a BBS supporting  hundreds of  users and  dozens of
  438. message-base  areas.   Sapphire  simply  does  not address  the  needs  of such
  439. systems.   This  is  in keeping  with  the "install-and-forget"  design of  the
  440. system, but it does mean that Sapphire doesn't suit everybody.
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.                                        2
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471. INSTALLING SAPPHIRE
  472.  
  473.  
  474.  
  475. What You Need
  476.  
  477.  
  478.  
  479. To run Sapphire, you need a PC-compatible computer with at least 512K of RAM, 2
  480. floppy disk drives  (or a  hard disk  -- which  is recommended)  and a  "smart"
  481. modem.  If you don't have a smart modem, you can still run Sapphire  in "local"
  482. mode.
  483.  
  484. Sapphire will run on MS- or PC-DOS Version 2.00 and higher.
  485.  
  486.  
  487. Hard and Floppy Disk Considerations
  488.  
  489.  
  490. If you install on floppies, the maximum size of a message will be 27 lines, and
  491. the upload/download function (whereby your computer can receive and send files)
  492. will not be available.   If you install on a hard disk (i.e.  no Sapphire files
  493. are on the A: or B: drives), messages may have up to 50 lines. 
  494.  
  495.  
  496.  
  497. Basic Steps
  498.  
  499.  
  500.  
  501. What follows is a brief description.  More details are given later.
  502.  
  503. To get Sapphire running on your system, you must follow these steps:
  504.  
  505. 1.   Make a backup copy of the original diskette.
  506.  
  507. 2.   Prepare a destination for the Sapphire files.
  508.  
  509.      A.   If using a hard disk, this  means creating a directory, usually named
  510.           Sapphire.
  511.  
  512.      B.   If using floppies,  this means formatting  two diskettes -- one  with
  513.           DOS and one without.
  514.  
  515. 3.   Copy the necessary files from the original diskettes to their proper place
  516.      (on a hard disk or a floppy).
  517.  
  518. 4.   Prepare your system for Sapphire  by placing a FILES=20 statement  in your
  519.      CONFIG.SYS file.
  520.  
  521. 5.   Configure Sapphire to work according to your wants and needs.  The SCONFIG
  522.      program helps you do this.
  523.  
  524.                                        3
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538. 6.   Run a local test.  The  SAPPHIRE LOCAL  command will do this.
  539.  
  540. 7.   Run a remote (modem) test.  The  SAPPHIRE  command does this.
  541.  
  542.  
  543.  
  544. STEP 1.  Make a Copy of the Packaged Diskettes
  545.  
  546.  
  547.  
  548. 1.   Insert  the SAPPH111 diskette  into your A:  drive.  Insert  a blank, for-
  549.      matted diskette into your B: drive.
  550.  
  551. 2.   Enter the following DOS command:
  552.  
  553.           COPY A:*.* B:*.*
  554.  
  555. 3.   Prepare a label, reading BACKUP OF SAPPH111 and affix this to the diskette
  556.      from the B: drive.
  557.  
  558. 4.   Repeat steps 1 to 3 for the SAPPH112 diskette.
  559.  
  560.  
  561.  
  562. STEP 2.  Prepare a Place for the Files to Go
  563.  
  564.  
  565.  
  566. FLOPPY DISK USER
  567.  
  568.      1.   Format a diskette with DOS and label this Sapphire A.
  569.  
  570.      2.   Format a diskette without DOS and label this Sapphire B.
  571.  
  572. HARD DISK USER
  573.  
  574.      1.   Change to the root directory of your hard disk.
  575.  
  576.      2.   Enter the command  MD Sapphire  to create a directory. 
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.                                        4
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603. STEP 3.  Put the Files Where They Belong
  604.  
  605.  
  606.  
  607. FLOPPY DISK USER
  608.  
  609.      1.   Copy all files from the SAPPH111 diskette to the Sapphire A diskette.
  610.  
  611.      2.   Put the Sapphire A disk in drive A: and the Sapphire B disk in the B:
  612.           drive.
  613.  
  614. HARD DISK USER
  615.  
  616.      1.   With the SAPPH111 diskette  in the A:  drive, change to the  Sapphire
  617.           directory of your hard disk.
  618.  
  619.      2.   Enter the following DOS command:
  620.  
  621.           COPY A:*.*
  622.  
  623.      3.   Insert the SAPPH112 diskette into the A: drive.
  624.  
  625.      4.   Enter the following DOS command:
  626.  
  627.           COPY A:*.*
  628.  
  629.  
  630.  
  631. STEP 4.  Updating the CONFIG.SYS File
  632.  
  633.  
  634.  
  635. Sapphire keeps quite a few  files open at once, so you will have  to use a text
  636. editor (such as the  Turbo Pascal editor, or Wordstar in  non-document mode) to
  637. modify or create a file called CONFIG.SYS.
  638.  
  639. FLOPPY DISK USER:  The file will go on your  Sapphire A  diskette.
  640.  
  641. HARD DISK USER:    The file will go in your root directory (C:\ usually).
  642.  
  643. The file should contain the following lines:
  644.  
  645.      FILES=20  
  646.      BUFFERS=20
  647.  
  648. In order for  the CONFIG.SYS information to  take effect, you must  boot from a
  649. disk containing that file.  Remember:  the file is read only when you  power up
  650. your  system.  Sapphire won't work if you  boot ("power up") from a floppy that
  651. doesn't have the proper CONFIG.SYS file.
  652.  
  653. For more information about CONFIG.SYS, see your DOS manual.
  654.  
  655.  
  656.                                        5
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671. STEP 5.  Customize Sapphire According to Your Needs
  672.  
  673.  
  674.  
  675. At the DOS prompt, enter this command:  SCONFIG
  676.  
  677. This command  will take  you through  all the  steps needed  to configure  your
  678. system.  Select  the "First-timers" checklist on  the menu.  After  you've read
  679. through that, select the "Total Configuration" option.  This must be run in its
  680. entirety before you try to run Sapphire.
  681.  
  682.  
  683. Saving Time on the Customization Step
  684.  
  685.  
  686. Initially, the system is set up as a "conversation service" named "The Pinnacle
  687. Club".  If this is appropriate to your requirements, feel free to use the  name
  688. and the text files.  However, if you have other plans for your Sapphire system,
  689. you can modify the various TXT files to conform to your needs.
  690.  
  691.  
  692.  
  693. STEP 6.  Run a Local Test
  694.  
  695.  
  696.  
  697. Make sure your time and date are set correctly, then enter this command:
  698.  
  699.      SAPPHIRE LOCAL
  700.  
  701. This runs Sapphire without any reference to the modem.
  702.  
  703. The first time you run Sapphire, it will create some data files.  This can take
  704. a while --  especially on floppy-based systems.   Once that is  done (hopefully
  705. without severe errors) you  will see the words "Awaiting Visitor".   This means
  706. everything is functioning properly.
  707.  
  708. If you'd like to  sign on now, refer to the "System  Operation" section of this
  709. manual.    If you  want  to move  to  the  remote test,  press  the ALT-F9  key
  710. (explained later) to shut down Sapphire.
  711.  
  712. If  you had  any  problems, refer  to the  "Trouble-Shooting"  section of  this
  713. manual.
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.                                        6
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735. Extra Step for Floppy Diskette Users
  736.  
  737.  
  738. Once you're  satisfied that the program basically works (although you might see
  739. some messages about missing files), you can delete the SCONFIG.EXE file to make
  740. room on the Sapphire A diskette.  Don't delete  it if it's your only copy!  You
  741. should have made a spare  copy in Step 1.  Once you've done this,  you can copy
  742. all the files from SAPPH112 onto the Sapphire A diskette.
  743.  
  744.  
  745.  
  746. STEP 7.  Run a Remote Test
  747.  
  748.  
  749.  
  750. You can start up Sapphire with full modem support by typing the command:
  751.  
  752.      SAPPHIRE
  753.  
  754. If this gives you any problems, refer to the "Trouble-Shooting" section of this
  755. manual.
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.                                        7
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801. TROUBLE-SHOOTING
  802.  
  803.  
  804.  
  805. In order of likelihood, the most common problems are:
  806.  
  807.      1.   You omitted a step or misunderstood the instructions.
  808.      2.   The modem isn't configured right.
  809.      3.   There is a file problem of some kind.
  810.      4.   Sapphire has a bug.
  811.      5.   The hardware is incompatible.
  812.  
  813.  
  814.  
  815. Problem 1.  Installer Error
  816.  
  817.  
  818.  
  819. I  apologize  for  listing you  as  the  most probable  cause  of  the problem.
  820. However,  the fact  is:   most installation problems  arise because  the person
  821. doing the  installation has  either skipped  a step  or  didn't understand  the
  822. instructions.
  823.  
  824. Please review what you have done, or ask somebody else to re-read the  instruc-
  825. tions.  Statistically,  this really does  give you the  best chance of  solving
  826. your problem.
  827.  
  828.  
  829.  
  830. Problem 2.  Modem Configuration
  831.  
  832.  
  833.  
  834. If  you had a problem running Sapphire in  LOCAL mode, then your problem wasn't
  835. the modem; skip this section.
  836.  
  837. If you have a Hayes-compatible modem, with Hayes-compatible switches, make sure
  838. your switches are set this way:
  839.  
  840.      Switch 1 UP:   Computer should use the Data Terminal Ready (DTR) line
  841.      Switch 2 UP:   Result codes sent as words
  842.      Switch 3 DOWN: Result codes are sent to the computer
  843.      Switch 4 UP:   Echo incoming characters
  844.      Switch 5 DOWN: Don't answer incoming calls
  845.      Switch 6 UP:   Computer should use the Carrier Detect (CD) line
  846.  
  847. The positions  of switches 7 and 8  are variable, depending on  your phone type
  848. and your modem  brand.  Consult your modem's manual to determine what should be
  849. done with these switches.
  850.  
  851.  
  852.  
  853.  
  854.                                        8
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.  
  866.  
  867. Some modems don't  have DIP  switches; you  have to configure  the modem  using
  868. commands.  In this case, you will have to accomplish with commands what we were
  869. trying to do with  the switches.  You will find that your modem has commands to
  870. perform the  important functions  of  switches.   For Hayes-compatible  modems,
  871. these  commands  are preceded  by the  "&"  character (&C1&D2  being  the usual
  872. values).
  873.  
  874. If you have an  external modem, are you sure  that pins 8 and 20  are connected
  875. from one end of the cable  to the other?  These are, respectively,  the Carrier
  876. Detect and Data Terminal  Ready signals.  Sapphire can operate  without the DTR
  877. signal  (see the  SCONFIG  program) but  it's  best to  have  it available,  if
  878. possible.
  879.  
  880. When Sapphire talks to the modem, you should see something like this:
  881.  
  882. Modem:  ATS0=1                              Response:  OK
  883.  
  884. If you see something like this:
  885.  
  886. Modem:  ///////                             Response:  <TIME-OUT>
  887.  
  888. ...it means Sapphire can't see your modem.  Check in SCONFIG to  make sure that
  889. you specified the write COM port.  Or if you have an internal modem, check that
  890. it's really on the COM port you think it's on.
  891.  
  892. If you see something like this:
  893.  
  894. Modem:  ///////                             Response:  OK
  895.  
  896. It means  that your  modem is  seeing the  command and  accepting  it, but  not
  897. echoing back the characters.  Check your modem set-up  string to make sure that
  898. you've told  the  modem to  echo.   (Since  the first  command sets  the  echo,
  899. sometimes it will be displayed as slashes; this is normal.)
  900.  
  901. If you see nothing whatsover  -- not even "Modem:" -- it means  that your modem
  902. has  the  CD (Carrier  Detect) line  locked  on.   Sapphire  won't try  to send
  903. commands to a modem that supposedly has a carrier there, since a carrier  means
  904. there's a caller  at the other end.   If your modem has  dip-switches, set them
  905. correctly (described above).  If your modem  uses & commands, you will have  to
  906. get into a terminal  program (such as ProComm, Boyan, QModem,  Telix, etc.) and
  907. type the command to unlock the CD line.  This command is typically AT&C1.
  908.  
  909. Some other kinds of modem problems can be fixed by experimenting with the modem
  910. settings configured by the SCONFIG program.
  911.  
  912. By the way, some  computers and modems just can't survive  running 24 hours per
  913. day.   If your system occasionally  crashes, try turning  it off for an  hour a
  914. day.   It may be necessary  to install a cooling  fan in the  computer unit and
  915. remove the back panel of the modem.
  916.  
  917. Never  overlook the obvious.   If you  have strange modem  problems, check your
  918. cables and so on.  Is everything plugged in solidly?
  919.  
  920.                                        9
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936. Problem 3.  File Problem
  937.  
  938.  
  939.  
  940. If you suspect  you have some  kind of file  problem, ask yourself these  ques-
  941. tions:
  942.  
  943. 1.   Did you put FILES=20 in your CONFIG.SYS  file?  If you did this, you  must
  944.      re-boot your system for this new value to take effect.
  945.  
  946. 2.   Are all the required files are available to Sapphire?  Did you specify the
  947.      correct drive  and/or directory when providing the file path data with the
  948.      SCONFIG program?
  949.  
  950. 3.   If you're using  floppies, do you have  the right floppies in  the drives?
  951.      Neither should have a write-protect tab.
  952.  
  953. 4.   Is it possible you  inadvertently deleted a file?   If you did, get  a new
  954.      copy from the installation disk.
  955.  
  956. If  you get I/O errors, you can look them up  in a copy of the manual for Turbo
  957. Pascal Version 4.0.  This might help you solve difficult problems.
  958.  
  959.  
  960.  
  961. Problem 4.  Sapphire Bug
  962.  
  963.  
  964.  
  965. If you think you've spotted a bug in Sapphire, send us a letter describing  the
  966. problem.   The most  important thing you  can do is  make it happen  on demand.
  967. That is to say, before  you report a problem, try to understand  it well enough
  968. to make it happen on purpose.
  969.  
  970. To assess  a problem,  I appreciate  getting as  much information as  possible.
  971. Send us information such as:
  972.  
  973. 1.   What do you think causes the problem?
  974. 2.   How often does it happen?
  975. 3.   Does it happen to everybody or just certain people?
  976. 4.   Did it start just recently or has it always happened?
  977. 5.   If it just started, what changed just before it started?
  978. 6.   What have you done to try to solve the problem?
  979.  
  980. Print-outs and screen-dumps can be helpful in assessing a problem.
  981.  
  982. IMPORTANT:     It may  be over-stating  the case,  but if  you are  reporting a
  983.                problem, you really do have a better chance  of getting a useful
  984.                answer if you provide us with answers to the numbered questions,
  985.  
  986.                                        10
  987.  
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.                above.  Take a moment to note down the answers before calling us
  1000.                or writing to us.  It'll save time in the end.
  1001.  
  1002.  
  1003.  
  1004. Problem 5.  Incompatible Hardware and Software
  1005.  
  1006.  
  1007.  
  1008. Sapphire  has  run problem-free  on  a  wide variety  of  computers, with  many
  1009. different brands  of modem.   I've heard  very few complaints  about incompati-
  1010. bility.    However, it  is possible  that certain  types of  modems (especially
  1011. internal modems) might  not behave properly.   If you  suspect your modem,  try
  1012. borrowing another brand for a while.
  1013.  
  1014. There can also be  problems with multi-tasking software.   The Sapphire  serial
  1015. routines are poll-driven rather than interrupt-driven.  What this means is that
  1016. if you're running multi-tasking  software, your users may lose  characters when
  1017. they type.   I plan to  address this drawback  in a later version  of Sapphire.
  1018. For the vast majority of systems, however, this is not a problem.
  1019.  
  1020. If you let me know  what is going wrong, I'll try to fix  Sapphire to work with
  1021. your hardware.
  1022.  
  1023.  
  1024.  
  1025.  
  1026.  
  1027.  
  1028.  
  1029.  
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.                                        11
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065. SYSTEM OPERATION
  1066.  
  1067.  
  1068.  
  1069. Duties of the System Operator
  1070.  
  1071.  
  1072.  
  1073. The user-name for the  System Operator is:  SYSOP.   You can also sign  up with
  1074. your real name and give yourself permanent sysop authority.
  1075.  
  1076. As the  sysop,  your main  task  is to  "validate"  (grant membership  to)  new
  1077. members.  You do this with the VALIDATE command.
  1078.  
  1079. You should  also backup  your files  from time  to time,  using the  DOS BACKUP
  1080. command, or a similar product.
  1081.  
  1082. If you have run other BBS's before,  you may be expecting that there are  other
  1083. duties to perform, such as maintaining upload/download lists, compressing files
  1084. and so on.
  1085.  
  1086. But you don't have to do  any of that.  Sapphire handles everything  automatic-
  1087. ally.   Your only tasks are Validation  and Backups.  And as  you'll see later,
  1088. even the Validation task is far easier than for other BBS's.
  1089.  
  1090.  
  1091.  
  1092. Signing On Locally
  1093.  
  1094.  
  1095.  
  1096. When Sapphire  is waiting for  a caller, press  any key.   This will  "wake up"
  1097. Sapphire and freeze out the modem by putting it "off-hook".  You can then  sign
  1098. on as if you'd dialed up.
  1099.  
  1100. If you don't  want your phone  off the hook,   you can start  up Sapphire in  a
  1101. non-modem mode.  At the DOS prompt, type:
  1102.  
  1103.    SAPPHIRE LOCAL 
  1104.  
  1105. This completely ignores anything to do with the modem.
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.                                        12
  1119.  
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.  
  1130.  
  1131. Signing on as SYSOP
  1132.  
  1133.  
  1134.  
  1135. The information presented below is based  on the default set-up.  For  security
  1136. reasons, the  password shown here  should be  modified (using the  BYE PASSWORD
  1137. command) as soon as possible.
  1138.  
  1139. 1.   Wait until Sapphire is waiting for a visitor.
  1140. 2.   Press a key to wake it up.
  1141. 3.   When asked for your name, press Space-bar, then Return.
  1142. 4.   When you're asked for the password,  type  SYSOP  then Return.
  1143.  
  1144.  
  1145.  
  1146. Function Keys
  1147.  
  1148.  
  1149.  
  1150. The function keys  are active whenever somebody is connected.  Here's what they
  1151. do:
  1152.  
  1153.  
  1154. REGULAR FUNCTION KEYS 
  1155.  
  1156. F 1  Function-key help.
  1157.  
  1158. F 2  Enable Yoo-Hoo.  Makes a noise when a specified person shows up.
  1159.  
  1160. F 3  Removes 10 minutes online-time from whoever is connected. 
  1161.  
  1162. F 4  Adds on 10 minutes online-time  to  whoever is connected. 
  1163.  
  1164. F 5  Enable/Disable the type-to-sysop (CHAT) command.
  1165.  
  1166. F 6  Break in to chat with the person who is currently online.
  1167.  
  1168. F 7  Not used.
  1169.  
  1170. F 8  Not used.
  1171.  
  1172. F 9  Modify number-of-hours-between-calls
  1173.  
  1174. F10  Sound effects on/off.
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.                                        13
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198. ALT FUNCTION KEYS
  1199.  
  1200. F 1  Turn printer on and off (uses LPT1).
  1201.  
  1202. F 2  Freeze out the  person on the modem.   You do this if you want  to enter a
  1203.      few quick commands on  his behalf but don't  want him to see what  you are
  1204.      typing.  Press ALT-F2 to restore communication.
  1205.  
  1206. F 3  Subtract 1 from the membership level of the person who is signed on.
  1207.  
  1208. F 4  Add 1 to the membership level of the person who is signed on.
  1209.  
  1210. F 5  Announce  mode on/off.   In announce  mode, nobody can log  on.   All
  1211.      people get to see is your sign-on logo.  Handy for announcements.
  1212.  
  1213. F 6  Send file.  This is used to transmit a text file -- usually while chatting
  1214.      with  a remote user.   This  function duplicates  exactly the  normal file
  1215.      transmission, so you can't use it while the user is already reading a file
  1216.      or a message.
  1217.  
  1218. F 7  Changes the name  of the visitor  to one that you  specify.  The  new
  1219.      name is checked to prevent duplication.
  1220.  
  1221. F 8  Instant banishment.  Removes visitor from valid caller list.
  1222.  
  1223. F 9  Shut-down.   If nobody is signed  on, Sapphire ends immediately.   If
  1224.      somebody is logged on, Sapphire will end when he or she logs off.
  1225.  
  1226. F10  Turn Ultra-Mode on  or off.   Ultra-Mode is a  kind of  "Super-Sysop"
  1227.      mode.  While in this mode, a user may...
  1228.  
  1229.      Execute commands of any level
  1230.      Send any number of messages (usual limit is Level + 3 SENDs per visit)
  1231.      Use the CHANGE command on somebody else's message
  1232.      Read private messages
  1233.      Call back in less than the usual time (Level 6+ can always do this)
  1234.      Skip around a devalidation message at signon and proceed normally
  1235.  
  1236.      The user named SYSOP is automatically in  Ultra-mode.  Other users -- even
  1237.      other Level 8  users -- must have  it turned on explicitly  by the ALT-F10
  1238.      key.  When ALT-F10 is pressed, a long, raucous sound is emitted  from your
  1239.      computer's speaker.   This tends to discourage people from hitting the key
  1240.      "by accident".
  1241.  
  1242.      Do not get the  impression that the existence of Ultra-Mode  allows you to
  1243.      give out Sysop (Level 8) authority lightly.  You should reserve that level
  1244.      for  yourself only.   However,  if you  would  prefer to  respect people's
  1245.      privacy, you could sign up with your real name, then use the ALT-F4 key to
  1246.      bring  yourself up  to Level  8.  Ultra-Mode  can then  be used  only when
  1247.      absolutely necessary.
  1248.  
  1249.  
  1250.                                        14
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265. Backups
  1266.  
  1267.  
  1268.  
  1269. Perhaps the most  important thing a  sysop can  do is make  backups!  The  most
  1270. important file, which should be backed up on a regular basis, is the user file,
  1271. which is named:
  1272.  
  1273.                                    SUSER.DAT
  1274.  
  1275.  
  1276. When  making backups,  it's a good  idea to  have a "father"  and "grandfather"
  1277. copy.   You can do this easily with a batch (.BAT) file.  Here's a sample batch
  1278. file for backing up the user list:
  1279.  
  1280.           ECHO OFF 
  1281.           ECHO Backing up Sapphire User List file to A: drive
  1282.           DEL A:USERBAKC.DAT
  1283.           RENAME A:USERBAKB.DAT A:USERBAKC.DAT
  1284.           RENAME A:USERBAKA.DAT A:USERBAKB.DAT
  1285.           COPY C:\SAPPHIRE\USERLIST.DAT A:USERBAKA.DAT 
  1286.           DIR A:USERBAK*.DAT
  1287.  
  1288. You may also wish to backup the messages, but this is not as critical.  (If you
  1289. have the time, it is still  a wise move.)  If you decide to do  this, the files
  1290. to be backed up are:
  1291.  
  1292.           -- The message-pointer file SNEXT.DAT
  1293.           -- The message-index file STIME.DAT
  1294.           -- The B* files in the message directory (e.g. B001)
  1295.  
  1296.  
  1297.  
  1298. User File Maintenance
  1299.  
  1300.  
  1301.  
  1302. The user file does not require maintenance.  It will hold up to 350 user names,
  1303. which has proven to be more than enough for a lively BBS.  
  1304.  
  1305. NOTE:     If you require a  larger user base, please contact  Pinnacle Software
  1306.           for a special edition of Sapphire (priced separately).
  1307.  
  1308. When a new user signs up, Sapphire looks for  an inactive user to replace.  The
  1309. higher the level of the  member, the longer it takes  for him to be  considered
  1310. inactive.  Here are the required call-back times:
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.                                        15
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.                Level   Time-Out (Days)  Member Level Description
  1330.                  1           10         Non-Member
  1331.                  2           50         Basic Member
  1332.                  3           60         Special Member
  1333.                  4           70         Top Notch Member
  1334.                  5           80         Inner Circle Member
  1335.                  6           90         Aide-de-Sysop
  1336.                  7          100         Co-Sysop
  1337.                  8          110         Sysop
  1338.  
  1339. Note that this is only the time after which a user is eligible for replacement.
  1340. If there are no  new sign-ups to replace his name on  the list, his user-record
  1341. can remain valid forever.
  1342.  
  1343. The user named SYSOP is never eligible for replacement.
  1344.  
  1345.  
  1346.  
  1347. Message File Maintenance
  1348.  
  1349.  
  1350.  
  1351. The message files do  not require maintenance.  Sapphire maintains  225 message
  1352. files.   When  the last  one is  used up,  the first  one is  replaced, thereby
  1353. "deleting" the oldest one.
  1354.  
  1355. All  messages share  the same space.   There  is no  way to preserve  a message
  1356. permanently.  If you have something you want to keep available for a long time,
  1357. insert it into the library directory as a .TXT file and tell the members to use
  1358. the LIBRARY command to review it.
  1359.  
  1360. If you really must get rid of  a message, use Sapphire's ERASE command.   There
  1361. is no need to use DOS DEL or ERASE.
  1362.  
  1363.  
  1364.  
  1365. Library Maintenance
  1366.  
  1367.  
  1368.  
  1369. The Sapphire Library does not require maintenance.
  1370.  
  1371. Any .TXT file that  appears in the Library directory will appear on the Library
  1372. list.   The 39-character description  of each article  is taken from  the first
  1373. line of each file.
  1374.  
  1375. Thus, you can add to the Library simply by copying text files into the  Library
  1376. directory, and remove  articles using the DOS  DEL command.  For  your members'
  1377. convenience,  you  might sort  the  directory  in reverse-date  order,  using a
  1378. utility such as Norton's DS command.
  1379.  
  1380.  
  1381.  
  1382.                                        16
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396. Files Maintenance
  1397.  
  1398.  
  1399.  
  1400. The files (upload/download) collection does not require maintenance.
  1401.  
  1402. Sapphire maintains a list of 500 uploads.  When the list is  full, programs are
  1403. dropped  from the  list and  deleted  from the  file directory  according  to a
  1404. formula based on:
  1405.  
  1406.           (A)  Number of times the file has been downloaded
  1407.           (B)  How many days have elapsed since the last request
  1408.           (C)  How many days the file has been on the list
  1409.  
  1410. In other words, Sapphire will identify and replace the least popular file.
  1411.  
  1412. NOTE:  For more information, see the "File Transfer" section of this manual.
  1413.  
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.  
  1429.  
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441.  
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.                                        17
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461. MISCELLANEOUS OPERATIONAL NOTES
  1462.  
  1463.  
  1464.  
  1465. Gear Shift
  1466.  
  1467.  
  1468.  
  1469. Sapphire supports adjustable output speed.  During output, a user can press one
  1470. of the number keys to "shift gears"  for a comfortable reading speed.  The keys
  1471. run from  1 (slow) to  9 (fast).   The 0 key  is the "top  gear" key.   It sets
  1472. output speed to maximum.
  1473.  
  1474. When the main command prompt comes up, output is reset to full speed.  This has
  1475. proven to  be  a convenient  arrangement.   However,  the  user can  reset  his
  1476. "default gear", via the  SPECS command.  Certain  types of line-noise  problems
  1477. have been solved by selecting a lower output speed.
  1478.  
  1479.  
  1480.  
  1481. Customization
  1482.  
  1483.  
  1484.  
  1485. There are  several files that  you can modify  to your  taste.  If  you're just
  1486. beginning, you  can skip this  -- but  come back to  this section after  you've
  1487. finished your initial experimenting.
  1488.  
  1489. To modify these files, you will need a text editor.  The  standard EDLIN editor
  1490. is an example of a  text editor.  You can also use the  Turbo Pascal editor, or
  1491. Wordstar in non-document mode.  Most word processors have a "Text" or "DOS Text
  1492. File" mode.
  1493.  
  1494. In technical terms, a text editor is any editor that marks  separate lines with
  1495. a "Carriage Return" character and marks the end of a file with a "Control Z".  
  1496.  
  1497.  
  1498. SLOGO.TXT
  1499.  
  1500.  
  1501. You can modify the  SLOGO.TXT file to specify a 20-line  banner that your users
  1502. will see at connect time.  You can mention the name of your BBS in this banner.
  1503. The names "Pinnacle Club" and "Sapphire" do  not appear anywhere in the program
  1504. itself (except for the version and copyright notice).
  1505.  
  1506. However, I  strongly encourage you  to call  your system  "The Pinnacle  Club".
  1507. That way, people already familiar with  the software will know what to  expect,
  1508. and may even seek out your system because they like the way it works.
  1509.  
  1510. The SLOGO.TXT  file contains a helpful  collection of sign-on logos,  which you
  1511. can modify to your needs, using a text-editor program.
  1512.  
  1513.  
  1514.                                        18
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528. Other .TXT Files
  1529.  
  1530.  
  1531. The other text files,  such as SINFO.TXT, SNEWH.TXT etc., contain straight text
  1532. for  the members to  read.   You should read  them yourself;  you'll learn what
  1533. they'll learn and  you'll spot any changes  that must be made,  such as address
  1534. and system-name information.
  1535.  
  1536.  
  1537. Command Levels
  1538.  
  1539.  
  1540. You may modify the command  levels by altering the files SCMDL.DAT with  a text
  1541. editor, or you can  delete the file to use the default settings.  Make sure you
  1542. have a backup copy before you delete it.
  1543.  
  1544.  
  1545.  
  1546. Password Changes
  1547.  
  1548.  
  1549.  
  1550. There is an undocumented feature in Sapphire which allows users to change their
  1551. passwords.  If you sign  off by typing BYE PASSWORD (no abbreviations) you will
  1552. be asked for a new password.
  1553.  
  1554. This  feature was  not explicitly  documented because  there has  long been  an
  1555. argument among  computer security  experts about  the wisdom  of letting  users
  1556. change (or even select) their passwords.
  1557.  
  1558. It might be best  to keep the BYE PASSWORD  feature secret if you give  users a
  1559. new password when you validate them.  Or perhaps you'll decide to avoid letting
  1560. them change their  password simply because they  tend to forget what  their new
  1561. password is.
  1562.  
  1563. Whether or not you let your users know about this feature is up to you.
  1564.  
  1565.  
  1566.  
  1567. The Status Line
  1568.  
  1569.  
  1570.  
  1571. The top  two lines  of the Sapphire  screen provide  you with  some information
  1572. about what is going on.  The top line lists  membership level, time left, state
  1573. icons (explained later), and the  last item that went in  the system log.   The
  1574. second line lists the member's sign-on name and full name, phone number.
  1575.  
  1576. The  state icons  are single-character indicators.   You  can think of  them as
  1577. on/off lights, if you wish.  Here's what they mean:
  1578.  
  1579.  
  1580.                                        19
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593. Downwards-pointing triangle:  The  ALT-F9 key was pressed to put  the system in
  1594. "shutdown  mode" and  will be closed  when it  next disconnects (i.e.  when the
  1595. current visitor logs off).  Memory aid:  points downwards to mean "going down".
  1596.  
  1597. Infinity symbol (sideways 8):  Ultra-mode is on.  This is turned on and  off by
  1598. the ALT-F10 key.  Memory aid:  "The infinite power of Ultra-mode is available."
  1599.  
  1600. Diamond:  The system is waiting for somebody in particular to show up.  You can
  1601. specify a list of names by pressing the F2 key.  Memory aid:  the people in the
  1602. list are highly prized.
  1603.  
  1604. Happy  face:   People  who use  the  CHAT command  will be  placed  directly in
  1605. conversation,  instead of seeing an "unattended"  message.  Memory aid:  you're
  1606. in a good mood, so you'll talk to people.
  1607.  
  1608. Question mark:   the current  user entered the  CHAT command to  try to get  in
  1609. touch with  you.  The  CHAT spell makes  a noise if  you have sound  turned on.
  1610. Memory aid:  "Hello?  Sysop?"
  1611.  
  1612. Exclamation mark:  You pressed the ALT-F6  key to put the system into "announce
  1613. only"  mode.  People  will only see  the SLOGO.TXT data  before getting discon-
  1614. nected.  Memory aid:  "Hear ye, hear ye!!!"
  1615.  
  1616. Double-note:  Sound  is on.  Turn it  on or off with the F10  key.  Memory aid:
  1617. music is sound.
  1618.  
  1619. Triple-line:  Printer is active.  The printer (which should be connected to the
  1620. parallel port LPT1) is turned on or off by the ALT-F1 key.
  1621.  
  1622. These icons may take a while to get used to, but before long, you'll be able to
  1623. tell at a glance what's happening on your system.
  1624.  
  1625.  
  1626.  
  1627. Online Validation and Banishment
  1628.  
  1629.  
  1630.  
  1631. ALT-F7 and ALT-F8  will validate or banish  the current visitor.   However, the
  1632. ALT-F7 key does not  update the file  until the member  disconnects, so if  you
  1633. have a system crash,  the file will still reflect  the old value.  In  general,
  1634. all data  affecting a member's current session is  lost if your system crashes,
  1635. since  the members  information is  written only  "on the  way out".   For this
  1636. reason, it is not possible for somebody to banish himself!
  1637.  
  1638.  
  1639.  
  1640. Yoo-Hoo and Rename
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.                                        20
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659. If you intend to  run a BBS  that does not tolerate  aliases, but insists  that
  1660. people use real names, the combination of F2 (Yoo-Hoo) and ALT-F7 (Rename) will
  1661. prove useful.
  1662.  
  1663. When you press the Yoo-Hoo key, you will be prompted to enter a list  of names,
  1664. separated by slashes.  For example, you might enter:
  1665.  
  1666.              Dagger Lord/The Wombat of Love/Power Petunia/Superstar
  1667.  
  1668. When somebody signs on under  any of the indicated names, Sapphire  will make a
  1669. distinctive noise to alert you.
  1670.  
  1671. You can then  break in  (using F6 --  Chat) and  tell the person  that you  are
  1672. changing his sign-on  name to his real name.  This  can be done with the Rename
  1673. key.  The Rename  function will not allow you to change the name to an existing
  1674. name.   Thus, if  you already  have a  John on  your system,  you can't  change
  1675. somebody else's name to John.
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.                                        21
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725. MEMBER PRIVILEGES
  1726.  
  1727.  
  1728.  
  1729. There are 8 "security levels" on Sapphire, ranging from level 1 (Non-member) to
  1730. level 8 (System Operator).
  1731.  
  1732. This  section describes  the original set-up  for member  privileges.   You can
  1733. change these settings by altering the SCMDL.TXT file.  These settings  are also
  1734. used if SCMDL.TXT is missing.
  1735.  
  1736.  
  1737.  
  1738. Level 1:  Non-member
  1739.  
  1740.  
  1741.  
  1742. May post in:        Non-member message base.
  1743.  
  1744. Commands:                COMMAND   DESCRIPTION OF COMMAND                 
  1745.                          BYE       Disconnect  from  system  (i.e. logoff)
  1746.                          HELP      Display a list of commands  you can use
  1747.                          INFO      Membership requirements for this system
  1748.                          SEND      Leave a message for other users to read
  1749.                          SPECS     Change the way things  look around here
  1750.                          VERSION   Display  software version and copyright
  1751.  
  1752. Comments:           Note the absence of the READ command.
  1753.  
  1754.  
  1755.  
  1756. Level 2:  Basic Member
  1757.  
  1758.  
  1759.  
  1760. May post and read:       Non-member and Basic member message bases.
  1761. May post in:          Feedback to Sysop message base.
  1762. May read:             Report from Sysop message base.
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.                                        22
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791. Additional commands:     COMMAND   DESCRIPTION OF COMMAND                 
  1792.                          EXPERT    Switch  between  casual and expert mode
  1793.                          GIMMICKS  Describes various  tricks  for messages
  1794.                          GRAPHICS  Switch  graphic  characters  on and off
  1795.                          HINTS     Tricks and tips  for using  this system
  1796.                          LIBRARY   Browse and read  in our  online library
  1797.                          MESSAGES  Quick summary of messages (time & user)
  1798.                          NAMES     Specify names  for  selecting READ etc.
  1799.                          PROTOCOL  Select  method  used for  file transfer
  1800.                          READ      Read  new messages  left by other users
  1801.                          REVIEW    Inspect a single message by DATE:MINUTE
  1802.                          RUN       Run special external programs ("Doors")
  1803.                          SET       Modify the DATE:MINUTE for READ command
  1804.                          TEXT      Specify text to reduce READ output etc.
  1805.                          TIME      Display how much time is left for visit
  1806.                          USERS     Display  information  about  our  users
  1807.  
  1808.  
  1809.  
  1810. Level 3:  Special Member
  1811.  
  1812.  
  1813.  
  1814. Additional base:         Special Member.
  1815.  
  1816. Additional commands:     COMMAND   DESCRIPTION OF COMMAND                  
  1817.                          ACTIVITY  Display system activity for past 7 days
  1818.                          CHANGE    Modify a message you've sent previously
  1819.                          FILES     List software available for downloading
  1820.                          GET       Get some software  from our  collection
  1821.                          GIVE      Contribute software  to our  collection
  1822.                          MOVE      Move a message from one base to another
  1823.  
  1824.  
  1825.  
  1826. Level 4:  Top Notch Member
  1827.  
  1828.  
  1829.  
  1830. Additional base:         Top Notch.
  1831.  
  1832. Additional commands:     COMMAND   DESCRIPTION OF COMMAND                 
  1833.                          CHAT      Page system operator for a conversation
  1834.                          OBSERVE   Overview of logon/logoff activity, etc.
  1835.  
  1836. Comments:           Note  that  lower-level  members,  when  doing  the   USERS
  1837.                     command, see  Top Notch members  listed as "Special".   Top
  1838.                     Notch messaging is hidden from lower levels.
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.                                        23
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857. Level 5:  Inner Circle Member
  1858.  
  1859.  
  1860.  
  1861. Additional base:         Inner Circle.
  1862.  
  1863. Additional commands:     None.
  1864.  
  1865. Comments:           Lower-level members,  when doing  a USERS  command, see  an
  1866.                     Inner  Circle  member  listed only  as  "Special"  (or "Top
  1867.                     Notch", in  the case  of Level  4 members).   Inner  Circle
  1868.                     messaging is hidden from lower levels.
  1869.  
  1870.  
  1871. Level 6:  Aide-de-Sysop
  1872.  
  1873.  
  1874.  
  1875. May post in:             Report from Sysop.
  1876.  
  1877. Additional commands:     COMMAND   DESCRIPTION OF COMMAND                 
  1878.                          ERASE     Remove message  (resets it to time 0:0)
  1879.  
  1880. Comments:           This level  of authority allows  people to keep  the system
  1881.                     tidy without having access to personal member  information,
  1882.                     such as phone numbers.
  1883.  
  1884.  
  1885.  
  1886. Level 7:  Co-Sysop
  1887.  
  1888.  
  1889.  
  1890. May read:           Feedback to Sysop.
  1891.  
  1892. Additional commands:     COMMAND   DESCRIPTION OF COMMAND                 
  1893.                          BANISH    Devalidate user (remove from user list)
  1894.                          DOORS     Update  your  list of  "Door"  programs
  1895.                          DOS       Shell out to DOS; type "EXIT" to return
  1896.                          DUMBTERM  Start dumb terminal  for outgoing calls
  1897.                          EVENTS    Schedule your BBS's  close-down  events
  1898.                          PROBE     Display user info  (see also USERS cmd)
  1899.                          VALIDATE  Grant a user  a higher membership level
  1900.  
  1901. Comments:           At  this  level,  the  USERS  command gives  more  detailed
  1902.                     information, such as password and phone number.  A co-sysop
  1903.                     can run the entire  system remotely.  He can  not, however,
  1904.                     find out the sysop's password.
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.                                        24
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921.  
  1922.  
  1923. Level 8:  Sysop
  1924.  
  1925.  
  1926.  
  1927. May post in:        Logon Announcements.
  1928.  
  1929. Additional commands:     COMMAND   DESCRIPTION OF COMMAND                 
  1930.                          CLOSE     Shut down system; prevent further calls
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.                                        25
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989. DOORS AND EVENTS
  1990.  
  1991.  
  1992.  
  1993. The highly  technical information  presented in  this chapter  is addressed  to
  1994. experienced sysops  only.   If you are  new to the  joys of sysoping,  it would
  1995. probably be best, for the time being, to avoid the DOORS and EVENTS commands.
  1996.  
  1997. Sapphire will function  perfectly well without  DOORS and EVENTS installed,  so
  1998. you can safely skip this chapter and come back to it later.
  1999.  
  2000.  
  2001. Definitions
  2002.  
  2003.  
  2004.  
  2005. Doors and events are both instances where the Sapphire program ends and control
  2006. is returned back to DOS.  In the case  of a door, the shut-down is initiated by
  2007. a  user;  for  events, the  shut-down  happens  automatically,  according to  a
  2008. schedule you set up.
  2009.  
  2010.  
  2011.  
  2012. Applications for Event Processing
  2013.  
  2014.  
  2015.  
  2016. Consider the following batch file.  (Note that the <-- arrow and following text
  2017. are comments, not part of the batch file.)
  2018.  
  2019.      REM Batch File Autoback
  2020.      :START                             <-- A batch file "label"
  2021.      SRUN                               <-- The main Sapphire program
  2022.      COPY SUSER.DAT A:SUSER.DAT         <-- Copy the user list
  2023.      GOTO START                         <-- Start over again
  2024.  
  2025. If you could arrange  to have the BBS come  down every night at 3:00,  it could
  2026. make a spare copy of the user list on the A: drive.  This would be very useful,
  2027. although of  course you'd have  to make  sure that  the A: drive  always had  a
  2028. floppy inserted and ready to go!
  2029.  
  2030. Set up in  this way, you could  leave town for  a long weekend, confident  that
  2031. your user list was being backed up every day.
  2032.  
  2033. This is  only  a very  simple  example of  the  benefits of  event  processing.
  2034. Another  possible application  is automatic  dial-out via  your  favourite com-
  2035. munications program (to pick up mail, perhaps).  Of course, you'd have to write
  2036. a "script" (i.e. a program that your comm program understands) in order to have
  2037. it dial out, sign on, pick up the mail, then return to DOS.
  2038.  
  2039. One very common use for  event processing is to support network systems such as
  2040. Fido -- a very complicated topic beyond the scope of this manual.   
  2041.  
  2042.                                        26
  2043.  
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058. Applications for Doors Processing
  2059.  
  2060.  
  2061.  
  2062. A door is an  external program that a user  can run from Sapphire.  (It  is, in
  2063. effect, a "door" into programs written by other people.)
  2064.  
  2065. There  are dozens  of  door programs  available.   One  example  is the  Pyroto
  2066. Mountain gaming  system, which was written by Pinnacle  Software.  You can call
  2067. it as  a door,  giving your members  a chance to  play this intriguing  game of
  2068. magic and politics.
  2069.  
  2070. Before making a door available to your members, you should review it carefully.
  2071. The quality of door software varies greatly; some may crash, thereby failing to
  2072. return to DOS and consequently taking your BBS "off the air".
  2073.  
  2074.  
  2075.  
  2076. Coding Your Batch Files
  2077.  
  2078.  
  2079.  
  2080. In an environment using doors and  events or both, everything is tied  together
  2081. with batch (.BAT) files.   (For detailed information about batch files, consult
  2082. your DOS reference manual.)
  2083.  
  2084. The  simplest kind  of batch file  was illustrated  in the  "automatic userlist
  2085. back-up" example shown earlier.   This was a just  a loop, executing one  func-
  2086. tion.  One problem, though ... you'll note that  there was no way to get out of
  2087. the loop!  So it wasn't a particularly useful program.
  2088.  
  2089. If you want  to call Sapphire  from any  directory, put a  batch file like  the
  2090. following one (which you  could call S.BAT) in  one of the directories  in your
  2091. PATH:
  2092.  
  2093.      ECHO OFF                      <-- Stop display of batch lines
  2094.      C:                            <-- Change to the right drive
  2095.      CD \SAPPHIRE                  <-- Change to your Sapphire directory
  2096.      SAPPHIRE %1 %2                <-- Jump to batch file SAPPHIRE.BAT
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.  
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.                                        27
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121. SAPPHIRE.BAT is a batch file that comes with Sapphire.  It looks like this:
  2122.  
  2123.      ECHO OFF                      <-- Stop display of batch lines
  2124.      SRUN %1 %2                    <-- Start up Sapphire
  2125.      EXTERNAL                      <-- Jump to batch file EXTERNAL.BAT
  2126.  
  2127. This batch file must be in the directory where SRUN.EXE resides.
  2128.  
  2129. The %1 and %2 after the SRUN allow  you to pass parameters to Sapphire, so  you
  2130. can start up the batch file with  SAPPHIRE LOCAL  to run without a modem.
  2131.  
  2132.  
  2133. How EXTERNAL.BAT Works
  2134.  
  2135.  
  2136. Don't look for a file named EXTERNAL.BAT in the Sapphire package -- there isn't
  2137. one.  EXTERNAL.BAT is created whenever Sapphire ends.
  2138.  
  2139. If  Sapphire  is shutting  down  because you're  closing  it  (using the  CLOSE
  2140. command, for example),  EXTERNAL.BAT will be empty.   As a result,  you'll drop
  2141. straight through to the DOS prompt.
  2142.  
  2143. For  doors  and  events,  however,  Sapphire  copies  other  batch  files  into
  2144. EXTERNAL.BAT.  So whatever was in those other batch files will get executed.
  2145.  
  2146. But how does this get us back to Sapphire?
  2147.  
  2148. Sapphire  copies  the other  batch file  into  EXTERNAL.BAT, then  appends some
  2149. additional instructions, as in this example:
  2150.  
  2151.      C:                  <-- Switch to Sapphire's "home" drive
  2152.      CD \SAPPHIRE        <-- Switch to Sapphire's "home" directory
  2153.      SAPPHIRE            <-- Jump to the SAPPHIRE.BAT batch file
  2154.  
  2155. And thus, the circle is completed.
  2156.  
  2157. Of course, the  extra instructions may  vary, depending on  where your copy  of
  2158. SRUN.EXE resides and the way you started up Sapphire.
  2159.  
  2160.  
  2161. Batch Templates
  2162.  
  2163.  
  2164. You will use the DOORS and EVENTS commands to specify which batch files will be
  2165. copied to EXTERNAL.BAT.   We will call  these files "Batch Templates",  because
  2166. although they end in .BAT, they are never actually run directly.
  2167.  
  2168. You can write  the templates without regard  to what happens after  the program
  2169. ends, because that's taken care of when Sapphire copies them to EXTERNAL.BAT. 
  2170.  
  2171. NOTE:   A template must  not call another  batch file,  unless that batch  file
  2172. contains the code to get back to SAPPHIRE.BAT.
  2173.  
  2174.                                        28
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188. Here's an example.  To call up the PYROTO door, you could write a template file
  2189. named PYROTO.BAT, which looks like this:
  2190.  
  2191.      C:                            <-- Make sure you're on the right drive
  2192.      CD \PYROTO                    <-- Change to the Pyroto directory
  2193.      PYROTO /DOOR                  <-- Start up the program
  2194.  
  2195.  
  2196.  
  2197. Writing Door and Event Programs
  2198.  
  2199.  
  2200.  
  2201. When Sapphire  calls a  door or event,  it always  creates a  file in the  root
  2202. directory of the drive containing Sapphire, named:
  2203.  
  2204.                                   SAPPHIRE.DAT
  2205.  
  2206. This file contains important information for doors  and events.  If you plan to
  2207. write door or event programs, you'll need access to this data.
  2208.  
  2209. Turbo Pascal source-code,  describing the layout of  the file, can be  found on
  2210. the SAPPH112 diskette, under the name SDOOR.INC.
  2211.  
  2212.  
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.                                        29
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253. FILE TRANSFER
  2254.  
  2255.  
  2256.  
  2257. The highly  technical information  presented in  this chapter  is addressed  to
  2258. experienced sysops only.  If you are a new sysop, it would be best to avoid the
  2259. PROTOCOL, GET, GIVE, FILES and DUMBTERM commands, for now.
  2260.  
  2261. Sapphire will function  perfectly well without file-transfer installed,  so you
  2262. can safely skip this chapter and come back to it later.
  2263.  
  2264.  
  2265.  
  2266. What is File Transfer?
  2267.  
  2268.  
  2269.  
  2270. With Sapphire's file-transfer feature  installed, you will be able  to exchange
  2271. software with  people who  dial  into your  system, using  the popular  XMODEM,
  2272. YMODEM and ZMODEM protocols.
  2273.  
  2274. Sapphire maintains a list of the 500  most popular programs (providing there is
  2275. enough space on your hard disk), along with statistics and documentation.
  2276.  
  2277. The file-transfer feature requires  a system equipped  with a hard-disk with  a
  2278. minimum of 1 Megabyte free space.
  2279.  
  2280.  
  2281.  
  2282. Installing File Transfer
  2283.  
  2284.  
  2285.  
  2286. In order to enable file-transfer (XMODEM, YMODEM  and ZMODEM), you must install
  2287. several files, as follows:
  2288.  
  2289. ---  The file-transfer program  (DSZ.COM) must be  copied to the main  Sapphire
  2290.      directory  (usually named  C:\SAPPHIRE).   This will  enable the  DUMBTERM
  2291.      command,  even  if  the rest  of  the  file-transfer  installation is  not
  2292.      completed.   To  extract DSZ.COM  from  the DSZ  archive file,  enter  the
  2293.      command:  ARCE DSZ
  2294.  
  2295. ---  The SAPPH archive files (SAPPH112 and  SAPPH112) and the file SAPPHIRE.S-D
  2296.      (from  SAPPH112)  must be  copied to  the  files directory  (usually named
  2297.      C:\SAPPHIRE\FILES).
  2298.  
  2299. Once  these files are in place, Sapphire will  create the files listing as soon
  2300. as you use GET, GIVE, PROTOCOL or FILES.
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.                                        30
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319. Adding Software Locally
  2320.  
  2321.  
  2322.  
  2323. To add a file to the software collection while you are at the console, you must
  2324. first  place  it in  the  files  directory (usually  named  C:\SAPPHIRE\FILES).
  2325. Sapphire's DOS command comes in handy, here.
  2326.  
  2327. Afterwards,  use the GIVE command.   For example,  if you'd added  a file named
  2328. PYROTO.ARC, you would then enter this command:
  2329.  
  2330. ==> GIVE PYROTO.ARC
  2331.  
  2332. You'd then be asked who  this file is for (everybody, sysop, etc.),  then asked
  2333. to write some documentation about the file.   (This step is described later, in
  2334. more detail.)
  2335.  
  2336.  
  2337.  
  2338. Adding Software Remotely
  2339.  
  2340.  
  2341. A remote user  follows essentially the  same steps as a  local user, though  he
  2342. must first upload the software using one of the available protocols.   (XModem-
  2343. Checksum, XModem-CRC, YModem, ZModem).
  2344.  
  2345. As  a reward for contributing software, he is granted "double-your-minutes-back
  2346. for this visit and the next".  For example,  if it took him 10 minutes, he gets
  2347. an extra  20 minutes for the current visit, plus  20 extra minutes for the next
  2348. session.
  2349.  
  2350.  
  2351.  
  2352. How Online Documentation Works
  2353.  
  2354.  
  2355. After contributing a file, the contributor may write up to 48 lines of documen-
  2356. tation, which other people will  be able to read before deciding whether or not
  2357. to download this file.
  2358.  
  2359. Online  documentation  that has  already  been written  can  be  re-used.   For
  2360. example, if you're making available a multi-file software package, you can tell
  2361. Sapphire to use one documentation file for all of the files.
  2362.  
  2363. Incidentally, if one of those software files is deleted, the documentation file
  2364. is retained -- as long as some other file is using it.
  2365.  
  2366. The documentation  step uses  the usual text  editor that  you use  for writing
  2367. messages.   No new  skills need  be learned.   In  fact, you  can even  include
  2368. private and exclusive messages in your documentation.
  2369.  
  2370.  
  2371.  
  2372.                                        31
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385. The documentation  is saved in  the files  directory, in a  file with  the same
  2386. root-name as the original file.   For example, a file named VARITALE.ARC  would
  2387. have a documentation  file named VARITALE.S-D associated with  it.  (S-D stands
  2388. for Software Documentation.)   If you don't like the documentation  that a user
  2389. has written, you can copy some better documentation over the S-D file.  All S-D
  2390. files are standard text files, prepared with a text editor.
  2391.  
  2392. Of course, if  several files point at  the same documentation file,  they won't
  2393. all  share  its root-name.    The  SAPPH111  &  SAPPH112 files  both  the  file
  2394. SAPPHIRE.S-D.  As Sysop, you can use the  FILES comand to change which documen-
  2395. tation file a software file uses -- although this will rarely be necessary.
  2396.  
  2397. Proper online documentation makes any file-transfer system much more efficient,
  2398. because people won't end up spending hours downloading things they really don't
  2399. need.  Encourage your members to write enlightening documentation!
  2400.  
  2401.  
  2402.  
  2403. Transfer Protocols
  2404.  
  2405.  
  2406.  
  2407. The YModem supported by  Sapphire is proper YModem, per the  original specific-
  2408. ation.   Some  very respectable  communications programs  confuse the  protocol
  2409. XModem-1K with YModem.   If your  users complain that  YModem doesn't work  for
  2410. them, suggest they switch  their communications program from YModem  to YModem-
  2411. Batch.
  2412.  
  2413. This version of Sapphire does not support "batch protocols" such that users can
  2414. upload  or download  several files  with  one command.   This  feature  will be
  2415. supported in another version, if there is a demand.
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.                                        32
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451. APPENDIX A -- ORDERING INFORMATION
  2452.  
  2453.  
  2454.  
  2455. There are two ways to order from Pinnacle Software:
  2456.  
  2457.  
  2458. BY PHONE: Pinnacle Software accepts  Visa and MasterCard for orders  of $35 and
  2459.           more.  Call us at (514) 345-9578.  The best times are between 6:00 PM
  2460.           and 9:00 PM, Eastern Standard Time.
  2461.  
  2462. BY MAIL:  If making payment  by mail, it is  best to use a certified cheque  or
  2463.           money-order.  Personal cheques  are held until cleared by  your bank,
  2464.           which can introduce a delay of several weeks.
  2465.  
  2466.  
  2467. Just a reminder:  Sapphire is not a free program.
  2468.  
  2469. That is to say,  you are welcome to evaluate  the product free of charge  for a
  2470. month.  If you continue to use it after that, you must register your copy.
  2471.  
  2472. If, after a month, you decide not to register your copy, kindly  do the follow-
  2473. ing:
  2474.  
  2475.      (A)  Stop using the product.
  2476.  
  2477.      (B)  Phone us or send us  a letter, to tell us in what  ways our
  2478.           product needs to be improved before you'll register it.  An
  2479.           appropriate questionnaire and envelope  can be printed  out
  2480.           by the HELP program.
  2481.  
  2482. You are  encouraged  to pass  around copies  of Sapphire,  so  that others  may
  2483. evaluate it.
  2484.  
  2485.  
  2486.  
  2487. Additional Products from Pinnacle Software
  2488.  
  2489.  
  2490.  
  2491. The following  diskettes may  be  obtained from  Pinnacle Software.   They  can
  2492. greatly enhance your system.  All three diskettes may be obtained from Pinnacle
  2493. Software for $35.
  2494.  
  2495. SAPPHSDA: This  package  contains this  manual  in WordPerfect  format (Version
  2496.           5.0).  This enables WordPerfect users to print out  a more attractive
  2497.           manual than is possible with the generic text format that is  usually
  2498.           shipped with Sapphire.
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.                                        33
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518. SAPPHSDB: This  package contains  a collection  of articles  for your  Sapphire
  2519.           library.  This includes the RULES  file (rules for Sapphire members),
  2520.           the STYLE  file (tips  for courteous  and effective  BBSing), plus  a
  2521.           sprinkling of commentaries  that will  spark discussion amongst  your
  2522.           users.
  2523.  
  2524. SAPPHSDC: Software grab-bag for your software collection.  (All  titles written
  2525.           by Pinnacle Software.)  Some of the programs:
  2526.  
  2527.           HLRB           Make Handy Little Reference Books
  2528.           LOVEFIRE       Adventure story for women only
  2529.           LW             Label Wizard label printing program
  2530.           MEGADIII       Mega-Doom -- the epitome of BASIC games
  2531.           PHONEMEM       Technique for remembering phone numbers
  2532.           PINNARTX       Amazing PC-ASCII art-work for any display
  2533.           SPACEINV       Arcade game for any display -- even monochrome
  2534.           SV             Set Video attributes for CGA, EGA, VGA, etc.
  2535.           VARITALE       BBS door program -- multi-author story-writing
  2536.           WEED           Utility to clean up text files
  2537.  
  2538. Also available from Pinnacle ($45 each -- includes registration) are the Pyroto
  2539. Mountain BBS/Door Adventure Gaming system and  the new Vortex Warpgate BBS/Door
  2540. Science-Fiction Battle simulation.
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.                                        34
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583. APPENDIX B -- SAPPHIRE DESIGNER NOTES
  2584.  
  2585.  
  2586.  
  2587. This section contains  no especially  important information.   It is  presented
  2588. here for those people  who might want to know why Sapphire was designed the way
  2589. it was.
  2590.  
  2591. You may  find that this section helps  you decide if Sapphire is  the right BBS
  2592. for you.
  2593.  
  2594. NOTE:     If you intend to run  Sapphire from a store, or as a customer support
  2595.           line, the information in this section is probably irrelevant.
  2596.  
  2597.  
  2598.  
  2599. Some Background
  2600.  
  2601.  
  2602.  
  2603. I've been involved with computers since 1971, and since those early  days spent
  2604. sweating over a 10 character-per-second Teletype,  my enduring passion has been
  2605. computer telecommunications.   I'm fascinated by the way it enables us to reach
  2606. out and grasp the  crystallized thoughts of a stranger.  We  can enter an amaz-
  2607. ing,  exciting universe.  Where  time can stand still  or flow sideways.  Where
  2608. people can flash across a continent in the blink of an eye.
  2609.  
  2610. Over the years,  I've worked  out countless designs  for computer  telecommuni-
  2611. cations systems.  Several of these  designs went beyond the planning stage  and
  2612. became reality.  It excites me that we basement programmers have this chance to
  2613. pioneer new methods of communication.
  2614.  
  2615. Some of the projects I've been involved with include:
  2616.  
  2617.      ACCESS:   Canada's first national consumer telecomputing service.
  2618.  
  2619.      PYROTO:   The BBS/Game  system (about  50,000 people  play it each  week).
  2620.                The latest version is available  from Pinnacle Software for $35.
  2621.                (Runs also as a door.)
  2622.  
  2623.      SASSy:    A  bizarre experiment  that  helped us  learn  what's wrong  and
  2624.                what's  right about  BBS's.   The spec and  a 2-year  report are
  2625.                available from Pinnacle Software ($10).
  2626.  
  2627. I also had the chance to provide some suggestions for Ron Sharp's extraordinary
  2628. INFINITy system, which  is a BBS  with a seemingly  infinite number of  message
  2629. bases.
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.                                        35
  2637.  
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649. Why Sapphire was Written
  2650.  
  2651.  
  2652.  
  2653. After years of  seeing other kinds of BBS's, I had  to admit that I didn't like
  2654. the way any of them worked.  I'm  not talking about minor annoyances -- my  own
  2655. program has dozens of  quirks that I intend  to iron out.  Rather,  I'm talking
  2656. about fundamental design decisions.
  2657.  
  2658. To my  knowledge (and  based on  my interpretation),  every single  one of  the
  2659. existing BBS packages evolved from RBBS.   Perhaps not in actual program  code,
  2660. but  certainly in concept.   They all  share the same  general features, though
  2661. admittedly most are vastly superior to the original RBBS!
  2662.  
  2663. I was  never tempted  to copy RBBS,  because I'd already  written my  first BBS
  2664. program long before anybody around here knew what a  BBS was.  It wasn't a very
  2665. sophisticated program, but it did put me on my own path.
  2666.  
  2667. It is important to understand that there was something of a computer revolution
  2668. in Montreal  during the  mid-to-late 70's.   A large number  of hackers  set up
  2669. house  on a local school board's HP2000 mini-computer.   We evolved our own set
  2670. of idioms, so when the first "mainstream" BBS (an Apple Networks) came to town,
  2671. we said, "BBS?   What's that?   Bulletin Broadcast System?"   We really  didn't
  2672. know!
  2673.  
  2674. Our  user-interface  idioms found  their way  into  various programs  that were
  2675. developed  locally.   And thus  they  were found  in ACCESS,  then  PYROTO, and
  2676. finally (after considerable mutation) in Sapphire.
  2677.  
  2678.  
  2679.  
  2680. Notes About the Design Philosophy
  2681.  
  2682.  
  2683.  
  2684. Commands
  2685.  
  2686.  
  2687. Sapphire uses word  commands, rather  than single-letter commands.   I  figure:
  2688. it's easier to remember words  than mnemonics -- especially when the  mnemonics
  2689. are tortuously contrived (as in the infamous [Y]ell for chat).
  2690.  
  2691. Since you  don't run  out of words  the way  you run  out of letters,  Sapphire
  2692. doesn't need multiple program layers where the same commands can mean different
  2693. things (e.g. [U]tilities or [U]pload), depending where you are.
  2694.  
  2695. Because I use  word commands, I tend  to make Sapphire somewhat  more conversa-
  2696. tional than a letter-command system.  I should mention that some people find my
  2697. programs fairly terse.   What  I mean  to say is  that, while  Sapphire is  not
  2698. chatty, it is more like a dialogue than you're likely to find on most BBS's.
  2699.  
  2700.  
  2701.  
  2702.                                        36
  2703.  
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.  
  2710.  
  2711.  
  2712.  
  2713.  
  2714.  
  2715. Maintenance
  2716.  
  2717.  
  2718. Sapphire  is a  zero-maintenance BBS.   I  design  programs this  way partially
  2719. because I'm lazy and partially because  in the 70's most Montreal hackers  were
  2720. in a position  to get cut  off from their  programs at any time.   (Most of  us
  2721. weren't  really supposed  to be  on  that central  system.)   As  a result,  my
  2722. associates and I got into the habit of designing programs that could survive on
  2723. their own.
  2724.  
  2725.  
  2726. 40 Column Text
  2727.  
  2728.  
  2729. Many people have expressed surprise at my extensive use of 40-column text.  The
  2730. obvious answer is that  there are still plenty of 40-column  screens out there;
  2731. the IBM-PC isn't the only personal computer in the world.
  2732.  
  2733. However, the real reason  is that when people are reading boring  text (such as
  2734. is necessary while  learning to use a BBS), they want  to scan it as quickly as
  2735. possible.  The fact is, 80-column text requires too much eye-movement  for easy
  2736. scanning; if newspapers can use narrow columns, so can I.  Why should I be held
  2737. hostage to the actual width of my screen?  No law forces us to fill each line.
  2738.  
  2739.  
  2740. The Cool Reception
  2741.  
  2742.  
  2743. The way by  which potential members are  introduced to Sapphire may  not strike
  2744. you as particularly inviting.  They are requested to send a message telling you
  2745. why they'd like to join.  A few people are so offended, they hang up immediate-
  2746. ly.
  2747.  
  2748. The actual  requirements for  the application  can easily  be changed,  though.
  2749. Maybe  you'll merely  ask them  to tell  you their  shoe-size.   But  if you're
  2750. running your BBS as a public service, I'd advise against it.
  2751.  
  2752. The vast majority of  BBS's go down within a few months  because the sysops are
  2753. appalled at the uncaring nature of the users.   But what can we expect?   Total
  2754. strangers call our boards; should we expect them to be nice to us?
  2755.  
  2756. You can greet them all  with open arms, but chances are, you'll  be very disap-
  2757. pointed.   These anonymous  people simply have  no particularly good  reason to
  2758. think you're special.
  2759.  
  2760. Far  too few novice sysops are  aware of the simple  fact that when you figura-
  2761. tively  "throw open your  doors", you can  get crumbs, bums,  free-loaders, and
  2762. jerks.  You also get some beautiful people, but it's hard to remember that when
  2763. you've got some fellow who signs on, makes a beeline for the files section, and
  2764. ties up your  line for hours as he pilfers your  software collection -- leaving
  2765. nothing in return.
  2766.  
  2767.  
  2768.                                        37
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781. It is utterly futile to be bitter.  The best solution is to be careful.
  2782.  
  2783. A  sysop's worst enemy is his own good nature.  He wants to spread his arms and
  2784. hug everybody who signs up to his system.   At first, he's excited that so many
  2785. people are visiting his BBS.  But later, when he realizes how many people treat
  2786. him like a bus service for software and information, he becomes disillusioned.
  2787.  
  2788. Perhaps I'm  wasting my time  telling this to  new sysops, but  the experienced
  2789. sysops will be nodding  their heads, by now.   The fact is:  either  you resign
  2790. yourself to being used  as a commodity, or you learn the  very difficult art of
  2791. rejecting new applicants.
  2792.  
  2793. Of  course,  what percentage  you reject  depends  on the  size of  your BBSing
  2794. community.  In Montreal, we have plenty of  people calling BBS's.  As a result,
  2795. I'm easily able to reject 95% of all applicants.  Mind you, that means that for
  2796. the first  2 months, my BBS was excruciatingly dull.  After all, how lively can
  2797. a BBS be, when it has only a handful of members?
  2798.  
  2799. Happily, though, I stuck to  my guns.  Nowadays, The  Pinnacle Club has a  nice
  2800. mix of people, all  of whom are what most  sysops consider "ideal BBSers".   It
  2801. almost took  more patience than I possess  (since, like most sysops,  I have an
  2802. urge to let everybody on), but it was worth it.
  2803.  
  2804. What makes Sapphire truly a "Zero-Maintenance BBS" is that you can judge people
  2805. by their reaction to  the request that they justify their  petition for member-
  2806. ship.   You  don't even  have to phone  them up!   What  people write  in their
  2807. application usually tells the whole story.
  2808.  
  2809. For example,  many people  write things like,  "Hi, I'd  like to  be a  member.
  2810. Please make me a member.  Thanks."
  2811.  
  2812. If such a  person can't even  be bothered to  justify himself, it  is extremely
  2813. unlikely he will make an effort to be a good, contributing member.
  2814.  
  2815. I've had  some extraordinary experiences  with this method of  validation.  One
  2816. fellow was incensed at the impersonal approach, but he took the time to express
  2817. his  objections in detail.   Bingo!  I  made him a  member.  He  later posted a
  2818. message to  the effect that he thought he'd  "gone to BBS heaven", so impressed
  2819. was he by the quality of the messages left by members!
  2820.  
  2821. Sapphire can be  easily modified to be less daunting to  the new user.  I don't
  2822. want to give you the impression that Sapphire must give all new  applicants the
  2823. cold shoulder.
  2824.  
  2825. But if  you're a new sysop,  I hope you'll think  about the kind  of people you
  2826. want on your system  and design accordingly.  Ask a  few experienced sysops for
  2827. advice.
  2828.  
  2829.  
  2830. Conclusion
  2831.  
  2832.  
  2833.  
  2834.                                        38
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847. Sapphire is not complete.   There are  numerous upgrades to be  made.  Some  of
  2848. these are summarized in Appendix C.
  2849.  
  2850. However, I would like to make it clear that it is not my intention for Sapphire
  2851. to be all things  to all people.  I  hope to retain the apparent  simplicity of
  2852. the design.
  2853.  
  2854. In  other words,  there are many  other BBS  packages out  there that  are more
  2855. grandiose in intent.  They can make your microcomputer look like a whopping big
  2856. mainframe.  But if you want a BBS that is easy for your users and easy for you,
  2857. I think you'll want to run Sapphire.
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.                                        39
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913. APPENDIX C -- Versions 1.1 and 2.x
  2914.  
  2915.  
  2916.  
  2917. Version 1.1 of Sapphire  is not much different from 1.0 except  for a few minor
  2918. phrasing changes to improve user understanding of Sapphire concepts.
  2919.  
  2920. We are currently  drawing up the  plans for Sapphire  Version 2.0.  The  design
  2921. work  is now complete, so it's time to get down to the coding.  That will start
  2922. about a week after we send this manual out.
  2923.  
  2924.  
  2925.  
  2926. Thank-You
  2927.  
  2928.  
  2929.  
  2930. During July of 1989, almost all Sapphire sysops around the world were contacted
  2931. by phone  by Pinnacle  Software, in  order to help  us plan  what will  go into
  2932. Version 2.x.   Let  us assure  you that  your opinions  have been  discussed at
  2933. length and  will have a positive effect  on upcoming versions of  Sapphire.  We
  2934. thank you for sharing your thoughts with us.
  2935.  
  2936.  
  2937.  
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943.  
  2944.  
  2945.  
  2946.  
  2947.  
  2948.  
  2949.  
  2950.  
  2951.  
  2952.  
  2953.  
  2954.  
  2955.  
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.                                        40
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.                                      INDEX
  2980.  
  2981.                 Can't find it here?  Try the Table of Contents.
  2982.  
  2983.  
  2984.      .BAT  27                                Crash  9, 20
  2985.      .S-D  32                                Credit Cards  33
  2986.      .TXT  16, 19                            Customization  18
  2987.      %1  28                                  Data Terminal Ready  8
  2988.      & Commands  9                           Default gear  18
  2989.      ACTIVITY  23                            Devalidation
  2990.      Aliases  20                                  Skipping  14
  2991.      ALT-F10  20                             Diamond  20
  2992.      ALT-F6  20                              DIP Switches
  2993.      ALT-F7  20                                   Modem  8
  2994.      ALT-F8  20                              Diskettes
  2995.      Announce  14, 20                             Problems  10
  2996.      ARTICLE  16                             Documentation
  2997.      Assistance  ii                               Uploaded software  31
  2998.      Awaiting Visitor  6                     DOORS  24, 26, 28
  2999.      B* files  15                            DOS  24, 26
  3000.      B001  15                                Download
  3001.      Backup  12                                   Definition  3
  3002.      Backups  15                             DSZ.COM  30
  3003.      BANISH  24                              DTR  8
  3004.           F-Key  14                          DUMBTERM  24, 30
  3005.      Banishment  20                          EDLIN  18
  3006.           Skipping  14                       ERASE  16, 24
  3007.      Basic Member  22                        EVENTS  24, 26, 28
  3008.      Batch protocols  32                     EXPERT  23
  3009.      BBS                                     EXTERNAL.BAT  28
  3010.           Brands  1                          F10  20
  3011.           Definition  1                      F2  20
  3012.      BUFFERS=  5                             F9  20
  3013.      Bugs  10                                Feedback  24
  3014.      Bulletin-board  1                       Fido  26
  3015.      BYE  22                                 File-transfer  30
  3016.           PASSWORD  19                       FILES  23, 30
  3017.      Call-back time  14                           Problems  10
  3018.      Carrier Detect  8                       Files collection  17
  3019.      CD  8                                   FILES=  5, 10
  3020.      CHANGE  14, 23                          Floppies
  3021.      CHAT  20, 23                                 Disadvantages  3
  3022.           Enable/Disable  13                 Freeze out  14
  3023.      CLOSE  25                               Function keys  13
  3024.      Club  1                                 Gear Shift  18
  3025.      Co-Sysop  24                            GET  23, 30
  3026.      Command levels  19                      GIMMICKS  23
  3027.      Compressing                             GIVE  23, 30, 31
  3028.           Not needed  12                     GRAPHICS  23
  3029.      CONFIG.SYS  5, 10                       Happy face  20
  3030.      Copyright  ii, 18                       Hayes modem  8
  3031.  
  3032.                                        41
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.      Heat  9                                 Number keys  18
  3046.      HELP  22                                OBSERVE  23
  3047.      Help!  8                                Output speed  18
  3048.      HINTS  23                               Password
  3049.      Hours-between-calls  13                      Changes  19
  3050.      I/O error  10                                SYSOP  13, 24
  3051.      I/O Errors                              Passwords  19
  3052.           Unexplained  10                    PCCONFIG  6
  3053.      IBM-PC  1                               Phone
  3054.      Icons  19                                    Off-hook  12
  3055.      Inactive user  15                       Pinnacle Club  18
  3056.      INFINITy  35                            Pinnacle Software
  3057.      INFO  22                                     Business hours  33
  3058.      Inner Circle  24                        PINNCL02
  3059.      Installation  ii                             Description  33
  3060.      Interrupt-driven  11                    PINNCL03
  3061.      Level                                        Description  34
  3062.           Description  16                    PinnClub  1
  3063.      LIBRARY  16, 23                              Design  2
  3064.           Description  16                    Poll-driven  11
  3065.      Line-noise  18                          Power-sysop  2
  3066.      LOCAL  12                               Printer  20
  3067.           Parameter  6                       Privacy
  3068.      Logo                                         Users'  14
  3069.           Sign-on  14                        Private
  3070.      LOGO.TXT  20                                 Reading  14
  3071.      LPT1  20                                PROBE  24
  3072.      Maintenance                             Problems  8
  3073.           Files collection  17               PROTOCOL  23, 30
  3074.           Library  16                        PYROTO  29, 35
  3075.           Message files  16                  RAM
  3076.           Time needed  1                          Requirements  3
  3077.           Userfile  15                       READ  23
  3078.      Member privileges  22                   REGISTER  33
  3079.      Members  1                              Registration  ii
  3080.      Membership level                        Rename  21
  3081.           Description  16                         F-Key  14
  3082.      Message                                 REVIEW  23
  3083.           Maximum size  3                    Root-name  32
  3084.      Message files  16                       RUN  23
  3085.      MESSAGES  23                            S-D
  3086.           Deleting  16                            Definition  32
  3087.           Limited number  14                 SAPPHIRE.BAT  28
  3088.           Saving  16                         SAPPHIRE.DAT  29
  3089.      Modem                                   SAPPHIRE.S-D  32
  3090.           Disabling  12                      SASSy  35
  3091.           Problems  9, 11                    SCMDL.DAT  19
  3092.      MOVE  23                                SCMDL.TXT  22
  3093.      NAMES  23                               SDOOR.INC  29
  3094.      New user  15                            Security levels  22
  3095.      Noise  13                               SEND  22
  3096.      Non-member  22                               File  14
  3097.  
  3098.                                        42
  3099.  
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.  
  3111.      Serial routines  11                          Definition  12
  3112.      SET  23                                 Validation  20
  3113.      Shareware  ii                           VERSION
  3114.      Shut-down  14, 20                            VERSION  22
  3115.      Sign-on                                 Versions  ii
  3116.           Logo  14                           Wombat  21
  3117.      Signing On  12                          Wordstar  18
  3118.      SINFO.TXT  19                           XMODEM  30
  3119.      SLOGO.TXT  18, 20                       XMODEM-1K  32
  3120.      SNEWH.TXT  19                           YMODEM  30, 32
  3121.      SNEXT.DAT  15                           Yoo-Hoo  13, 21
  3122.      Software collection  17                 Zero-maintenance
  3123.      Sound  13, 20                                Goals  1
  3124.      Special Member  23                      ZMODEM  30
  3125.      SPECS  18, 22
  3126.      SRUN  26
  3127.      Status Line  19
  3128.      STIME.DAT  15
  3129.      SUSER.DAT  15
  3130.      Switch  8
  3131.      SYSOP  12
  3132.           Definition  1
  3133.           Password  13, 24
  3134.           Sign-on  13
  3135.           Time-out  16
  3136.      System Operator  12
  3137.      TEXT  23
  3138.      Text editor
  3139.           Examples  18
  3140.      Tim  31
  3141.      TIME  23
  3142.           Add  13
  3143.           Remove  13
  3144.           Upload bonus  31
  3145.      Time-Out
  3146.           Inactive user  16
  3147.      Top lines
  3148.           Status  19
  3149.      Top Notch  23
  3150.      Total Configuration  6
  3151.      Triangle  20
  3152.      Ultra-Mode  14, 20
  3153.      Upload
  3154.           Definition  3
  3155.      Uploads
  3156.           Number of  17
  3157.      User
  3158.           Inactive  15
  3159.      User file  15
  3160.      Userfile  15
  3161.      USERS  23
  3162.      VALIDATE  24
  3163.  
  3164.                                        43
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.